Document details

The Invoice API provides key functionalities:

• Get the status from the government for the e-invoice

API URLs

Property	Value
Sandbox	https://malaysia-sandbox.complyance.io
Production	https://malaysia-prod.complyance.io/
Endpoint	/getDocumentDetailsFromLHDN
Method	POST

---

Headers

Header	Type	Description	Example	Conditionality
x-api-key	string	API Key for authentication	1aN3AQ8ZsggJ0UABAHXVB	Mandatory
invoiceMethod	string	The method of invoicing (e.g., non-peppol)	non-peppol	optional
Content-Type	string	Defines that the body is in JSON format	application/json	optional

---

Shell

curl --location 'https://malaysia-prod.complyance.io/getDocumentDetailsFromLHDN' 
--header 'x-api-key: k4PW_J0s8DtBSdvYnadXn' \
--header 'Content-Type: application/json'

Javascript

const headers = {
  'x-api-key': 'k4PW_J0s8DtBSdvYnadXn',
  'Content-Type': 'application/json'
};

fetch('https://malaysia-prod.complyance.io/getDocumentDetailsFromLHDN', {
  method: 'POST',
  headers: headers
})
.then(function(response) {
    return response.json();
}).then(function(body) {
    console.log(body);
});

Ruby

require 'rest-client'

headers = {
  'x-api-key' => 'k4PW_J0s8DtBSdvYnadXn',
  'Content-Type' => 'application/json'
}

response = RestClient.post 'https://malaysia-prod.complyance.io/getDocumentDetailsFromLHDN', {}, headers

puts response.body

Python

import requests

headers = {
  'x-api-key': 'k4PW_J0s8DtBSdvYnadXn',
  'Content-Type': 'application/json'
}

response = requests.post('https://malaysia-prod.complyance.io/getDocumentDetailsFromLHDN', headers=headers)
print(response.json())

PHP

<?php

$headers = [
    'x-api-key' => 'k4PW_J0s8DtBSdvYnadXn',
    'Content-Type' => 'application/json'
];

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://malaysia-prod.complyance.io/getDocumentDetailsFromLHDN', [
    'headers' => $headers
]);

echo $response->getBody()->getContents();
?>

Java

URL url = new URL("https://malaysia-prod.complyance.io/getDocumentDetailsFromLHDN");
HttpURLConnection con = (HttpURLConnection) url.openConnection();
con.setRequestMethod("POST");
con.setRequestProperty("x-api-key", "k4PW_J0s8DtBSdvYnadXn");
con.setRequestProperty("Content-Type", "application/json");

int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();

while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

Go

package main

import (
	"net/http"
)

func main() {
	headers := map[string][]string{
		"x-api-key":    []string{"k4PW_J0s8DtBSdvYnadXn"},
		"Content-Type": []string{"application/json"},
	}

	req, err := http.NewRequest("POST", "https://malaysia-prod.complyance.io/getDocumentDetailsFromLHDN", nil)
	if err != nil {
		// Handle error
	}

	for key, values := range headers {
		for _, value := range values {
			req.Header.Add(key, value)
		}
	}

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		// Handle error
	}
	defer resp.Body.Close()
}

---

Request Body

The request body for the Document detail should be structured as follows:

{
    "documentUuid": "ZG9KWZ1Q2BPSG9XWMN4485AJ10"
}

Request Body Fields

Field	Type	Description	Example
document	string	Unique identifier received from government as an acknowledgement

Sample Response Body

Success Response (HTTP 200 OK)

{
    "uuid": "TV7TPWJ9AE96NWAET8M5M6DJ10",
    "submissionUid": "2EC23WRQW2Y8KZGDT8M5M6DJ10",
    "longId": "1F7WWXTW7BT2G2FQT8M5M6DJ102qJYM41732168044",
    "typeName": "Invoice",
    "typeVersionName": "Version 1",
    "issuerTin": "C21540299050",
    "issuerName": "SMK ELECTRONICS (MALAYSIA) SDN. BHD.",
    "receiverId": "C4861199090",
    "receiverName": "SMK CORPORATION",
    "dateTimeReceived": "2024-11-21T05:47:24Z",
    "dateTimeValidated": "2024-11-21T05:47:25Z",
    "totalExcludingTax": 1000.0,
    "totalDiscount": 0.0,
    "totalNetAmount": 0.0,
    "totalPayableAmount": 1000.0,
    "status": "Valid",
    "createdByUserId": "C21540299050:c421a4e0-9d13-421d-94ee-f27483733a54",
    "documentStatusReason": null,
    "cancelDateTime": null,
    "rejectRequestDateTime": null,
    "validationResults": {
        "status": "Valid",
        "validationSteps": [
            {
                "status": "Valid",
                "error": null,
                "name": "Step03-Duplicated Submission Validator"
            },
            {
                "status": "Valid",
                "error": null,
                "name": "Step04-Code Field Validator"
            },
            {
                "status": "Valid",
                "error": null,
                "name": "Step05-Taxpayer Profile Validator"
            },
            {
                "status": "Valid",
                "error": null,
                "name": "Step06-Document References Validator"
            },
            {
                "status": "Valid",
                "error": null,
                "name": "Step07-Document Currency Validator"
            }
        ]
    },
    "internalId": "wwwde",
    "dateTimeIssued": "2024-11-19T02:30:00Z",
    "encodedQrCode": "iVBORw0KGgoAAAANSUhEUgAAAPoAAAD6AQAAAACgl2eQAAACiUlEQVR4Xu2YTY7qQAyEHbHoZY6Qm8DFIoHExeAmfYQss0DxqyojJjMazZbSE14E5HxI3cY/1R35t93ip+eHfYCyD1DmAjwCNk/tvhzgGK+9bXFOOicjAJ8LPCeg63HM3kBlqxc+QAwA4Ln2CO6C+2k37MwN6Cnb4tCBXiZLIOMYtfYQaQcwHxhgPvJKryLPFzbAq7L2j19L732ADPGOMXMdkLnrSRuQuQAoeuYD3Kis4/iY2jYiafkjJyA3dqY76ilZVHFC+a+BpPABErFd+N8vEVj7lY2em2LztwEek3o81s5GRfQ2Kj24KRsg5EZs56huxfRF5Hf58H6Ay4Znw9or6NgFElnp4QIkP+YJ5VWNvivKalQ+gPLhWU94oJHmwuFpBSTdh5531hgbKQXTxJag/XkAHEkUb/QgVdHysakgbwQgAY5x5tovCDpkiPIhOEt9AISVgp1zqUvVtacgsQKCHmpNPLIEsdBwAqZqmlh2cHgy+kzf3UhyAJAPMOYDqAjKpHhuygdobO8xMOhUxcpc+iYfQArkQBmHzGVL1TTCwfebRHk7oB6lQxBCDVRjHvbahQGQui6QFq7TOfNVw8kI6EwFvuP5Au9WqrqnCPUBGuupokxKqonNlU8ToE49obmkQ5q20kT5AHw3l3hbmb6gLiH9aQWckroDpYR3ScGEQotX+XsA9W4QNfKeiJHfD9b3A7K6PeiVGVJIOy1nADzoQb7q/FgAt2IGTEnxBgAiXpcdQr8dJw0AuGfeAvOeiAoEqcCtfPUoGwDfMZfulJ5oT73uEbwAzU1N+LNGJpv/bAVgxfTwW7khk9RcjQD++TM9OPhurLFB3f5LFRsAf9oHKPsAZf8J8A+DCH15PA3P1gAAAABJRU5ErkJggg=="
}

Error Response

{
  "uuid": "CR10K32STZXCE46MFXS62EEJ10",
  "submissionUid": "3RBHHC1YPZCDCA95FXS62EEJ10",
  "longId": "",
  "typeName": "Invoice",
  "typeVersionName": "Version 1",
  "issuerTin": "C58794843040",
  "issuerName": "Name of Supplier",
  "receiverId": "C21540299050",
  "receiverName": "ABC company",
  "dateTimeReceived": 1733491386000,
  "dateTimeValidated": 1733491386000,
  "totalExcludingTax": 1000,
  "totalDiscount": 0,
  "totalNetAmount": 0,
  "totalPayableAmount": 1060,
  "status": "Invalid",
  "createdByUserId": "C58794843040:01c8ede8-5782-44c8-87ee-d547639631ad",
  "documentStatusReason": null,
  "cancelDateTime": null,
  "rejectRequestDateTime": null,
  "validationResults": {
    "status": "Invalid",
    "validationSteps": [
      {
        "status": "Valid",
        "error": null,
        "name": "Step03-Duplicated Submission Validator"
      },
      {
        "status": "Invalid",
        "error": {
          "propertyName": null,
          "propertyPath": null,
          "errorCode": "Error04",
          "error": "Step04-Invalid Code Field Validator",
          "errorMs": "Step04-Pengesah Medan Kod Tidak Sah",
          "innerError": [
            {
              "propertyName": "cbc:IndustryClassificationCode",
              "propertyPath": "/ubl:Invoice/cac:AccountingSupplierParty/cac:Party/cbc:IndustryClassificationCode",
              "errorCode": "CV302",
              "error": "ItemCode 1111 does not exist in CodeType MSIC Codes",
              "errorMs": "Kod Item 1111 tidak wujud dalam Jenis Kod MSIC Codes",
              "innerError": null
            }
          ]
        },
        "name": "Step04-Code Field Validator"
      },
      {
        "status": "Valid",
        "error": null,
        "name": "Step05-Taxpayer Profile Validator"
      },
      {
        "status": "Valid",
        "error": null,
        "name": "Step06-Document References Validator"
      },
      {
        "status": "Valid",
        "error": null,
        "name": "Step07-Document Currency Validator"
      }
    ]
  },
  "internalId": "Invoice- 01",
  "dateTimeIssued": 1733279400000
}

Response Fields:

• status: Indicates the status of the API call (e.g., "success", "error").
• message: A human-readable message providing further information about the result.

Responses

Status Code	Description
200 OK	Invoice data validated successfully.
400 Bad Request	Invalid or malformed request.
500 Internal Server Error	An error occurred on the server.